package cn.iocoder.yudao.module.stock.service.stock;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.stock.controller.admin.stock.vo.*;
import cn.iocoder.yudao.module.stock.dal.dataobject.stock.StockDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 商品库存 Service 接口
 *
 * @author 徐煜东
 */
public interface StockService {

    /**
     * 创建商品库存
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createStock(@Valid StockSaveReqVO createReqVO);

    /**
     * 更新商品库存
     *
     * @param updateReqVO 更新信息
     */
    void updateStock(@Valid StockSaveReqVO updateReqVO);

    /**
     * 删除商品库存
     *
     * @param id 编号
     */
    void deleteStock(Long id);

    /**
     * 获得商品库存
     *
     * @param id 编号
     * @return 商品库存
     */
    StockDO getStock(Long id);

    /**
     * 根据商品id获得商品库存
     *
     * @param productId 商品编号
     * @return 商品库存
     */
    StockDO getStockByProductId(Long productId);

    /**
     * 获得商品库存分页
     *
     * @param pageReqVO 分页查询
     * @return 商品库存分页
     */
    PageResult<StockDO> getStockPage(StockPageReqVO pageReqVO);

}
